home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 3 / CDPDIII.bin / pd / graphics / lyapunovia / lyapunovia doc < prev    next >
Text File  |  1993-05-25  |  34KB  |  959 lines
  1. V1.5                  - Lyapunovia Users' Guide -                    Page 1
  2.  
  3.  
  4.  
  5.  
  6.                                 Welcome to
  7.  
  8.  
  9.  
  10.                              -----------------
  11.                             | LYAPUNOVIA V1.5 |
  12.                              -----------------
  13.  
  14.  
  15.  
  16.                       © Copyright 1992/93 Jesper Juul
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                                  Contents:
  24.                                  ---------
  25.  
  26.  
  27.          Introduction to Lyapunovia.............................2
  28.  
  29.          Installation...........................................4
  30.  
  31.          Getting started........................................5
  32.  
  33.          Program functions......................................6
  34.  
  35.          Tips & tricks..........................................9
  36.  
  37.          In-depth explanations.................................10
  38.  
  39.          Contacting the author, The serious part...............12
  40.  
  41.          Notes.................................................13
  42.  
  43.          Footnotes.............................................15
  44.  
  45.  
  46.  
  47.  
  48.                       "Why do I have to keep reading
  49.                          these technical manuals?"
  50.  
  51.                                -Roger Waters
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66. V1.5                  - Lyapunovia Users' Guide -                    Page 2
  67.  
  68.  
  69.                         Introduction to Lyapunovia
  70.                         ==========================
  71.  
  72.  
  73. -Tired of zooming endlessly around the Mandelbrot set?
  74.  
  75.  
  76. -Irritated  by  little  graphic  thingys  daftly  named  "Sea of solitude",
  77. "Dragons mouth", "Mountain of magic", or even worse?
  78.  
  79.  
  80. -Bored by a 1000 dull fractal  programs  all  the  same,  except  for small
  81. twists concerning the "cache modes" of the "68030"?
  82.  
  83.  
  84. Well, this is no cure. This is Lyapunovia V1.5.
  85.               --               ---------------
  86.  
  87.  
  88. But what then, is Lyapunovia?
  89. -----------------------------
  90.  
  91. -To be brief, Lyapunovia makes pictures. 
  92.  
  93. -To be  more elaborate,  Lyapunovia IS a fractal program, and it does allow
  94. you to zoom.... But it is  NOT a  Mandelbrot program.  (Everybody should be
  95. screaming  with  relief  at  this  point.)  The  great  thing  here  is the
  96. variations of the images; from cute candy-like patterns to ragged  and torn
  97. metal.   Lyapunovia   pictures   contain  depth  and  strange  interacting,
  98. ever-changing shapes with NO names.
  99.  
  100. -Lyapunovia is Shareware.
  101.  
  102.  
  103. And what is Lyapunovia V1.5?
  104. ----------------------------
  105.  
  106. When I originally  released  Lyapunovia,  I  used  the  traditional "stingy
  107. programmer" shareware  concept: I  released a  _good enough_ program to the
  108. public, but kept all the fancy  functions such  as AGA  and FPU  support to
  109. myself and the registered users. This worked out just fine.
  110. But after a while, a feeling of sillyness came to me: Why spend hours, days
  111. and weeks in social isolation for the benefit of so few people?
  112. I thought for a long time and decided  to release  _the full_  program this
  113. time. This  makes _me_  feel good  anyway, and I hope that _you_, the user,
  114. will appreciate it.
  115.  
  116. From the original V1.0, a lot  of things  has happened;  the user interface
  117. has  improved,  many  functions  have  been speeded up, support for various
  118. chips and 24-bit output has been added. Most of the  changes were suggested
  119. by various users.
  120. I've tried  to make  a program that takes advantage of AGA graphics and the
  121. 68040 internal FPU on a 4000, but still runs on an old '500.
  122.  
  123.  
  124. (The mathematically disinterested  should  skip  the  following explanatory
  125. part and go directly to "Installation" and "Getting started".)
  126.  
  127.  
  128.  
  129.  
  130.  
  131. V1.5                  - Lyapunovia Users' Guide -                    Page 3
  132.  
  133.  
  134. The mathematical way
  135. --------------------
  136. Where Mandelbrot  graphics (the  ones you've  seen a  100 times before) are
  137. renditions of the "Mandelbrot  Set",  Lyapunovia  renders  "Lyapunov Space"
  138. (unsurprisingly   named   after   the  russian  matematician  Aleksandr  M.
  139. Lyapunov).  If  the  Mandelbrot  set  is   the  "most   complex  object  in
  140. mathematics",  Lyapunov  Space  must  be  the  juiciest,  spiciest and most
  141. outrageous object ever found within numbers.
  142.  
  143. The specific formulas  used  to  produce  these  breathtaking  picures were
  144. thought up  by  Mario Markus of the Max Planck institute for Nutrition. And
  145. it all reached my mind by means of the "Mathematical Recreations" column in
  146. the September, 1991 issue of "Scientific American".
  147.  
  148. If you've  ever spent  some time with the Mandelbrot set, zooming, changing
  149. colors, etc... You'll be  well off  to understanding  how Lyapunovia works.
  150. Picture  a  square  with  coordinates,  going horisontally from 2.0 to 4.0,
  151. vertically from 2.0 to 4.0:
  152.  
  153.               (X1)       (X2)
  154.                2.0        4.0
  155.                --------------
  156.       (Y1) 2.0 |            |
  157.                |    The     |
  158.                |  Picture   |
  159.       (Y2) 4.0 |            |
  160.                --------------
  161.  
  162. That's what you see  when running  the program.  Lyapunovia enables  you to
  163. zoom in,  to watch  in closer detail whatever part of the screen appeals to
  164. you. This is like the Mandelbrot set.
  165.  
  166. What makes Lyapunov Space perhaps so much more fascinating, is  the ability
  167. to switch  between an  endless amount of different domains, each possessing
  168. an individual "personality" of sorts. And  things are  very strange, jagged
  169. and torn. Very appealing to any decently deranged imagination.
  170.  
  171. Like  the  Mandelbrot  set,  Lyapunov  Space  is  a  map of chaos, meaning:
  172. Lyapunovia calculates the "Lyapunov exponent" of each pixel;  an indication
  173. of whether  the formula  is order  or chaos at the given X and Y-positions.
  174. Chaos is mapped as black, order is mapped with the  highest colors  for the
  175. orderliest function.  The basic  formula is  equivalent to the one used for
  176. making "Feigenbaum trees"; x=rx(1-x).  The Lyapunov  exponent is calculated
  177. like this:
  178.  
  179.  
  180. ;A SMALL PROGRAM FOR DETERMINING THE LYAPUNOV EXPONENT
  181.  
  182. X=0.5     ;JUST AN INITIAL VALUE
  183. TOTAL=0
  184. ITERATIONS=50
  185. R=3.5     ;OR SOMETING ELSE BETWEEN 2 AND 4.
  186.  
  187. FOR I=1 TO ITERATIONS
  188.  X=RX(1-X)
  189.  TOTAL=TOTAL+LOG(ABS(R-2RX))/LOG(2)
  190. NEXT I
  191.  
  192. TOTAL=TOTAL/ITERATIONS
  193.  
  194.  
  195.  
  196. V1.5                  - Lyapunovia Users' Guide -                    Page 4
  197.  
  198.  
  199. The  TOTAL  variable  now  holds  the  Lyapunov  Exponent  for  the formula
  200. X=RX(1-X).
  201. Now you should be asking yourself:  How  does  one  plot  a two-dimensional
  202. picture when  the formula only has one parameter? Right: What we do is, for
  203. each iteration, to  replace  R  with  either  the  X  coordinate  or  the Y
  204. coordinate  of  the  pixel  we're  going  to  plot.  The sequence parameter
  205. determines how X & Y should alternate: An "AB" sequence does X,  then Y, X,
  206. then Y and so on... "AAB" does X,X,Y,X,X,Y... and so on and so forth.
  207.  
  208. Naturally,  there  are  various  ways  to  rewrite  the formula to speed up
  209. calculations as I've done,  but this  should give  you an  idea of  what is
  210. going on.
  211.  
  212. Reading on Lyapunov Space:
  213. --------------------------
  214. Scientific American,  September 1991.  A.K. Dewdney: "Leaping into Lyapunov
  215. Space".
  216.  
  217. Generally on fractals & chaos:
  218. ------------------------------
  219. Brian H. Kaye: A Random Walk Through Fractal Dimension. VCH, 1989.
  220. H.O. Peitgen, P.H. Richter: The Beauty of Fractals. Springer, 1986.
  221.  
  222.  
  223. --------------------------------------------------------------------------
  224.  
  225.  
  226.                            Installing Lyapunovia
  227.                            =====================
  228.  
  229.  
  230. Lyapunovia  uses  Nico  Francois'  ReqTools  library  for  file-requesters,
  231. information boxes, palette requesters and the like, therefore:
  232.  
  233. Before running,  REQTOOLS.LIBRARY (version 2.0 or above) must be present in
  234. your LIBS: directory. In the "Install" drawer of  this distribution, you'll
  235. find instructions as how do this.
  236.  
  237. Also  make  sure  to  have  the mathtrans.library in the LIBS: directory as
  238. well. (It comes with the computer, so don't worry.)
  239.  
  240.  
  241. Program versions
  242. ----------------
  243. Three different program versions are included in this distribution:
  244. "Lyapunovia V1.5 68000"  - for unaccelerated A500/A1000/A2000.
  245. "Lyapunovia V1.5 68020+" - for accelerated Amigas, A1200,3000,4000.
  246. "Lyapunovia V1.5 FPU"    - for Amigas with a floating point unit.
  247. All three versions will run under 1.3-3.0, and will automatically adjust to
  248. your computer.
  249.  
  250.  
  251. Libraries, screens and memory allocation
  252. ----------------------------------------
  253. Whenever the  program is unable to open a library or a screen, or unable to
  254. allocate some required memory, it will instantly exit  and clean everything
  255. up. An alert (the flashing thing) will then inform you of the error.
  256. If using  WB3.0+ on  a non-AGA  machine, trying to load a 256-color picture
  257. will result in a "unable to open screen"-error.
  258. Using 1.2-2.1, the picture just won't  be loaded,  instead calculations are
  259. started based on the coordinates.
  260.  
  261. V1.5                  - Lyapunovia Users' Guide -                    Page 5
  262.  
  263.  
  264.                               Getting started
  265.                               ===============
  266.  
  267. To quickly get a feel of what Lyapunovia does, do the following:
  268. Install  Lyapunovia.  Double-click  on  the  icon.  The  title-screen  will
  269. appear, press "OK" to continue.
  270.  
  271. (In the following, letters within {}  indicate  that  the  function  can be
  272. activated by press "right amiga" and that key.)
  273.  
  274. The program will start making a very simple Lyapunovia picture. Note that I
  275. generally programmed Lyapunovia to  automatically  begin  calculating every
  276. time a  parameter has been changed. You can always stop the program via the
  277. menus or by pressing right amiga+"." (the latter being much faster).
  278.  
  279.  
  280. Do the following:
  281. -----------------
  282.  
  283. Stop the program. {.} Try choosing a new screenmode:
  284. -On 1.2/1.3, select # of colors etc.. from the menus.
  285. -On 2.0-3.0, press {M} to get a screenmode requester.
  286.  
  287. Let the picture finish.
  288.  
  289. That was easy enough, but you've  probably noticed  that the  picture isn't
  290. very interesting.  So lets try loading a coordinate file: A coordinate file
  291. is simply a little  file describing  a certain  "place" in  Lyapunov Space.
  292. When  you   load  a   coordinate  file,   Lyapunovia  automatically  starts
  293. calculating it in the current screenmode, with the current palette.
  294. Load a coordinate file, say "Cross" or "ABBBBA  24 -  3". {D}  (You'll find
  295. the files in the "Coordinates" drawer of this distribution.)
  296.  
  297. While the  picture is  being calculated,  you can experiment with different
  298. palettes; with menus or by pressing  right-amiga and  1,2,3, or  4. -Or try
  299. bringing up the palette requester. {P}
  300.  
  301. Once the  picture's done, try loading some palette files. In the "Palettes"
  302. drawer, you'll find a lot of different palettes:
  303. -On a 256-color AGA screen, try "256 - Shiny" or "256 R&G".
  304. -On a 32-color screen, try "32 - lift up my nights".
  305.  
  306. Try selecting a cycle speed of 1 {Z}, then try the "cycle" function. {Y}
  307.  
  308. If you like the picture, try  saving it,  using "Save  IFF". {S}  From then
  309. on, you  can print  it, edit  it or  whatever you want to do. At some later
  310. time, you can also load the  picture again,  change the  colors or  zoom in
  311. somewhere that looks interesting - this is the next point:
  312.  
  313. Zooming is  very simple: You can select the area you want to see in further
  314. detail either from corner to corner {R} or from center  to corner  {N}. Try
  315. it; a requester will appear, asking if you're sure. If you were, the screen
  316. is cleared and the image you've selected starts being drawn.
  317.  
  318.  
  319. To more fully appreciate what Lyapunovia has to offer, this is how  to make
  320. some of my favorite pictures: (Load the palette, then the coordinate file.)
  321.  
  322.  
  323.  
  324.  
  325.  
  326. V1.5                  - Lyapunovia Users' Guide -                    Page 6
  327.  
  328.  
  329. Coordinate file               Palette (AGA / non-AGA)
  330. ------------------------------------------------------
  331. Flash; Curve II               256 Cycle - II / 32 Cycle - III
  332. 5A5B 50, ibd 11               256 - Shiny / #1
  333. 5A5B 50, 'In-between, detail' #4 / #4
  334. 5A5B 50, 'In-between'         #4 / #4
  335. 5A5B 50, ibd something        256 - R&G / 32 - Light up my nights
  336. 6A6B 30, Agurk                #4 / #4
  337. ABABA 50, Radiant             256 - R&G / 32 Cycle, Bilal II
  338. ABABA 50, Spider              256 - Lift my days / 32 - Lift my Days
  339. 5A5B 50, ibd 5                256 - Shiny / #4
  340. 5A5B 50, The Big Parable      256 - Yellowie Eyes / 32 - Greenscale
  341. AB 100, 'Indian Eyes"         #4 / #4
  342. 6A6B 30, 'CrissCross'         256 Cycle - III / 32 Cycle - III
  343. 5A5B 50, 'Loneliest Object'   #4 / #4
  344. Flash; 6AAB, 'Cross'          256 Cycle - Seventies  / 32 Cycle - II
  345.  
  346. (#1 means standard palette 1; right amiga + 1.)
  347.  
  348. If you  like a  picture, you  san always save it {S}, and then reload it at
  349. some later time for deeper zooming.
  350.  
  351. If you want to produce a 24-bit file, just load  the coordinate  file, stop
  352. {.}, press  {F}. Select  dimensions, select  a palette file, then an output
  353. file name.
  354. To make sure that the color transitions are absolutely smooth, you may want
  355. to expand  a palette  file first  {X}: Select the palette to expand, select
  356. the # of colors to expand to (just say 4096), then the file name of the new
  357. palette. To avoid confusion, it can be a good idea to name the palettes the
  358. way I've done: Thus expand "256 - Shiny" to "4096 - Shiny".
  359.  
  360.  
  361. A general rule is  that you  should zoom  on the  border between  black and
  362. color. That's where the "action" usually is.
  363.  
  364.  
  365. --------------------------------------------------------------------------
  366.  
  367.  
  368.                              Program functions
  369.                              =================
  370.  
  371.      (NOTE: letters  within {}  indicate that the function can be activated
  372.      by press "right amiga" and that key.)
  373.  
  374.      (In order  to  gain  speed,  Lyapunovia  will  only  check  for menus,
  375.      pressed keys  etc. every now and then. This is unnoticable on pictures
  376.      with a low "iteration" value; with large values (larger than, say, 500
  377.      on  an  unaccelerated  Amiga),  there  will be a noticeable delay from
  378.      selecting a menu till the program reacts. Don't worry, your Amiga will
  379.      remember what you did!)
  380.  
  381.  
  382.  
  383.  
  384. Menu 1: PROGRAM
  385. ---------------------------------
  386. This concerns basic program and file options.
  387.  
  388. Stop:             Stops drawing the picture. {.}
  389.  
  390.  
  391. V1.5                  - Lyapunovia Users' Guide -                    Page 7
  392.  
  393.  
  394. Go:               Though   changing   almost  any  parameter  automatically
  395.                   restarts  calculations,  you  sometimes  need  a separate
  396.                   function to do this. This is it. {G}
  397.  
  398. Save IFF:         Saves  the  current  picture  as a standard IFF file. {S}
  399.                   (Note 2.)
  400.  
  401. Load IFF:         Loads  a  picture   saved   from   Lyapunovia,  including
  402.                   coordinates etc... This enables you to continue exploring
  403.                   where you left off... {L}
  404.  
  405. Save Prefs:       Saves     the     current     screen      settings     as
  406.                   "S:Lyapunovia.prefs".  This  file is automatically loaded
  407.                   when the program is started.
  408.  
  409. Load Prefs:       Loads the preference settings.
  410.  
  411. About:            A bit of information about Lyapunovia. {A}
  412.  
  413. Priority:         Sets the task priority of Lyapunovia. Generally speaking,
  414.                   "1" gives  Lyapunovia priority  over most other programs,
  415.                   "0" splits the CPU time, and  "-1" makes  the program run
  416.                   quietly in the background.
  417.  
  418. Quit:             Quits Lyapunovia. {Q}
  419.  
  420.  
  421. Menu 2: SCREEN
  422. --------------
  423. This concerns screen resolution and colors.
  424.  
  425. Palette:
  426.  
  427.  Edit:            Edit palette. {P}
  428.  
  429.  Palette 1-4:     Four different standard palettes. {1,2,3,4}
  430.  
  431.  Cycle:           Performs a standard color cycle on the current picture. I
  432.                   realise  that  this  is  probably  the  oldest  and least
  433.                   original  effect  on  the  Amiga,  but  boy! it does look
  434.                   great. Anyway, press mouse button or any key to stop. {Y}
  435.  
  436.  Cycle speed:     Some people asked for  a faster  cycle, some  asked for a
  437.                   slower. This  function allows you to select the delay (in
  438.                   screen frames) between each step of a cycle. {Z}
  439.  
  440.  Save:            Saves the current palette in a standard format. {V}
  441.  
  442.  Load:            Loads a new palette. Note that it is  possible to  load a
  443.                   palette from any standard IFF file.
  444.                   Loading a  palette with a different number of colors than
  445.                   the the current will delete the  current image.  A prompt
  446.                   appears, asking you to confirm. {O}
  447.  
  448.  Rotate:          When you  perform a  cycle, sometimes  you'll notice some
  449.                   unexpectedly good-looking color-combination that you want
  450.                   to  keep.  This  function  moves through a standard cycle
  451.                   step by  step,  allowing  you  to  save  the good-looking
  452.                   colors when they appear.
  453.  
  454. Title bar:        Toggles the title bar. {T}
  455.  
  456. V1.5                  - Lyapunovia Users' Guide -                    Page 8
  457.  
  458.  
  459.  
  460.  
  461. Screenmode:       Users with  WB2.0+ can  change screen resolution and # of
  462.                   colors using a  single  menu.  This  replaces  the below-
  463.                   mentioned  menus.  Lyapunovia  supports  ALL  resolutions
  464.                   supported by the system software. If you seem  to be able
  465.                   to a  select a mode that causes strange flickering or the
  466.                   like, please note that this is due to a faulty preference
  467.                   setting, not a faulty program!
  468.                   As  standard,   the  program   assumes  the  screen  size
  469.                   specified  as  "Text  overscan"  in  the  preferences. To
  470.                   produce  pictures  bigger  than  the  screen,  enter  the
  471.                   desired dimensions in the  "width" and  "height" gadgets.
  472.                   If  the  screen  requires  more  chip ram than avaliable,
  473.                   you'll be returned  to  the  previous  resolution.  On an
  474.                   oversize  picture,  the  screen will automatically scroll
  475.                   when you move your pointer around. (Note 1.)
  476.  
  477. Hires:            Turns  high  resolution  on/off.  (640  pixels  per line,
  478.                   rather than 320.) * Under WB1.3 only!
  479.  
  480. Interlace:        Turns interlace  mode on/off. (PAL: 512 lines rather than
  481.                   256. NTSC: 400 lines  rather  than  200.)  *  Under WB1.3
  482.                   only!
  483.  
  484. 2-32 Colors:      Selects the  number of colours on screen. (2, 4, 8, 16 or
  485.                   32.) (Note 1.) * Under WB1.3 only!
  486.  
  487.  
  488. Menu 3: IMAGE
  489. -------------
  490. For moving around in Lyapunov Space.
  491.  
  492. Coordinates:      Alters the specifications of the current  image. See "In-
  493.                   depth explanations" for elaboration.
  494.  
  495. Zoom in:
  496.  
  497.  Center/corner:   To  zoom  with  the  mouse.  Point  at  the center of the
  498.                   "place" you want to view, hold left mouse button and move
  499.                   mouse  to  the  corner  of  the  square.  Release button.
  500.                   Lyapunovia will ask you if you're sure. {N}
  501.  
  502.  Corner/corner:   Same as above, except  that  you  select  from  corner to
  503.                   corner. {R}
  504.  
  505. Zoom out:
  506.  
  507.  All the way:     Returns you to the initial coordinates.
  508.  
  509.  2 times:         Zooms out two times. 
  510.  
  511.  4 times:         Zooms out four times.
  512.  
  513. Save:             This  saves  the  current  image  setting;  the  settings
  514.                   specified under  the  "Coordinates  menu":  What sequence
  515.                   you're using, and where you're zooming, etc.. {E}
  516.  
  517. Load:             This loads  such a  file. You  can also  load them from a
  518.                   Lyapunovia IFF file. {D}
  519.  
  520.  
  521. V1.5                  - Lyapunovia Users' Guide -                    Page 9
  522.  
  523.  
  524. Precision:
  525.  
  526.  Half:            Half precision is a special "preview" mode to quickly see
  527.                   what a  picture will  look like.  Faster, especially on a
  528.                   68000 system. This mode has to be selected  manually. Not
  529.                   very useful, really.
  530.  
  531.  Single:          Single precision is the default precision. Precise enough
  532.                   for most purposes. Switching back to this mode  has to be
  533.                   done manually.
  534.  
  535.  Double:          Double  precision  is  for extra deep zooming. Lyapunovia
  536.                   will  automatically  switch  to  this  mode  when  it  is
  537.                   required.
  538.  
  539. 24-bit output:
  540.                   This is  what a  lot of people have been asking for for a
  541.                   long time. It's fairly simple; to  produce a  picture you
  542.                   just enter  the dimensions  (in pixels), select a palette
  543.                   and an output file name, and away you go. The  picture is
  544.                   always  drawn  based  on the current coordinates. Maximum
  545.                   dimensions are  65000 x  65000 pixels.  Note: The picture
  546.                   on the  screen doesn't  have to be fully drawn before you
  547.                   do the 24-bit output; the normal  display should  be seen
  548.                   as  a  navigator  to  help  you  produce  the best 24-bit
  549.                   pictures  possible,  24-bit  output   is  independent  of
  550.                   current screen resolution etc.. (Note 4".) {F}
  551.  
  552. 24-bit palette expansion:
  553.                   Since a lot of people don't have AGA, and since even with
  554.                   AGA it can be hard to manipulate colormaps  with over 256
  555.                   colors, this is a small tool to help you: What it does is
  556.                   that it takes a previously existing palette file and then
  557.                   "expands it", smoothing any jumpy color-differences along
  558.                   the way, allowing you to get smooth color  transitions in
  559.                   your 24-bit  output. (Incidentally: This can also be used
  560.                   to turn old 16/32 color palettes  into 256-color palettes
  561.                   for use on AGA machines.) {X}
  562.  
  563.  
  564. --------------------------------------------------------------------------
  565.  
  566.  
  567.                                Tips & Tricks
  568.                                =============
  569.  
  570. Cycle
  571. -----
  572. For optimum  results, use  a palette  where color 1 is nearly equivalent to
  573. the last color. That way, cycling is less "jumpy". The  "32 color  cycle I"
  574. palette is a good example thereof, so is "256 - shiny".
  575.  
  576.  
  577. Where do i zoom?
  578. ----------------
  579. Well, in the end you should let your own tastes decide:
  580.  
  581. Do you  like the  soft &  smooth quality  of "Candy" with palette #1? -Then
  582. focus on pictures with  a low  "iteration" value;  don't zoom  to deep, but
  583. experiment with "color-divide" and palettes instead.
  584.  
  585.  
  586. V1.5                  - Lyapunovia Users' Guide -                   Page 10
  587.  
  588.  
  589. If  you  prefer  the  spaced-out  metallic  of  "AAB 100, Indian eyes" with
  590. palette #4, then stick to fairly high iteration  values and  always zoom on
  591. the edges between black and color, in places that seem layered.
  592.  
  593. For  the  rather  moving,  "loneliest mathematical object in the universe"-
  594. feeling of "5a5b 50, zoom1", zoom  on the  little islands  of color  in the
  595. blackness.
  596.  
  597. Note  that  all  images  change appearance radically when changing palette.
  598. Try the "X-ray" palettes!
  599.  
  600. Sometimes, but seldomly, you may experience  the feeling  that the pictures
  601. you get tend towards the repetitive.
  602. The  official  advice  is  this:  Zoom  where  you don't usually zoom! That
  603. usually does the job. After having played with Lyapunov Space  for nearly a
  604. year, I still get a lot of surprises. The possibilities are endless.....
  605.  
  606.  
  607. --------------------------------------------------------------------------
  608.  
  609.  
  610.                    In-depth explanation of a few points:
  611.                    =====================================
  612.  
  613.  
  614. Coordinates, the short explanation:
  615. -----------------------------------
  616.  
  617. If you're  not that  interested in  mathematics, you  only need to know one
  618. thing: The "coordinates" menu decides what your picture should look like:
  619. "Sequence" make the picture ...... different.
  620. "Color-divide" changes the brightness of the picture.
  621. "Iterations": The bigger the number, the  stranger the  picture, the slower
  622. the program.
  623. "Plot repeat": Repeats the palette.
  624.  
  625.  
  626. Coordinates, the in-depth explanation:
  627. --------------------------------------
  628.  
  629. Sequence
  630. --------
  631. Selects the  general formula  you want to look at. Not as complicated as it
  632. sounds: Lyapunovia works by  -  at  each  point  on  the  screen  - running
  633. through  a  basic  formula  as  many  times  as  you  specify  in the field
  634. "Iterations".
  635. In this field, only the letters "A" or "B" are legal. "A"  runs through the
  636. formula  using  the  X  coordinate  of  the  current  point, "B" uses the Y
  637. coordinate. To give an example: A  sequence  of  "ABABB"  and  7 iterations
  638. will repeat the formula like this:
  639.  
  640. A,B,A,B,B,A,B            -The "sequence", repeated.
  641. X Y X Y Y X Y            -Its' X or Y partner.
  642. 1 2 3 4 5 6 7            -The current iteration.
  643.  
  644. That is to say that sequences are wrap-around.
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651. V1.5                  - Lyapunovia Users' Guide -                   Page 11
  652.  
  653.  
  654. Color-divide
  655. ------------
  656. Determines  the  general  brightness  of  the  picture.  When using default
  657. palette #1, a high  color-divide makes  the picture  light, a  low one will
  658. make the  picture dark. I can't tell you what color-divide should be set to
  659. at all times -  rather  you  should  experiment  from  picture  to picture,
  660. adjusting this  number along with the palette. Nevertheless, a good rule is
  661. to stay between 1500 and 5000.
  662.  
  663.  
  664. Iterations
  665. ----------
  666. This determines how many times the basic formula  should be  repeated - for
  667. each iteration, the program moves to the next step of the "sequence". Thus,
  668. if you specify fewer iterations than the sequence is long, only part of the
  669. sequence will be executed.
  670. The more  iterations, the  more weird the picture... And the longer time to
  671. do calculations. (Note 3.)
  672.  
  673.  
  674. Plot repeat
  675. -----------
  676. With a value of 1, the palette is distributed evenly by mathematical means.
  677. Higher  "plot   repeat"  values   will  distribute  the  palette  _several_
  678. consecutive times. If you then alter the palette  so color  1 and  the last
  679. color are close, and then cycle, you'll have a great effect of moving bars.
  680. Check out the "Curve  x4 II"  with different  cycle-palettes to  see what I
  681. mean. Do try it with a cycle speed of 1!
  682.  
  683. Only 1-4 are valid plot repeat values.
  684.  
  685.  
  686. Errors
  687. ------
  688. When  pressing  "OK"  in  coordinates,  the  program will inform you of any
  689. faulty values... Respond accordingly. If you're lost, just  press "UNDO" or
  690. "CANCEL".
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716. V1.5                  - Lyapunovia Users' Guide -                   Page 12
  717.  
  718.  
  719.                            Contacting the author
  720.                            =====================
  721.  
  722. Contacting me
  723. -------------
  724. First of  all, you're  always welcome to contacting me with any suggestion,
  725. bug report (aargh!) or comment that springs into your mind. 
  726.  
  727. If you've  found somewhere  nice in  Lyapunov Space;  a great  palette or a
  728. great picture  or some  great coordinates, please mail them to me. You will
  729. then .... be mentioned in the next doc. file!
  730.  
  731.  
  732. The serious part
  733. ----------------
  734. And now the serious part: Since the last release of the program,  I decided
  735. not to keep a speciel registered version of the program to myself and a few
  736. registered users, but rather to share it with as many people as possible.
  737.  
  738.  
  739. In return for that, I'd like _you_ to share something with me:
  740.  
  741. The suggested shareware fee for this program is 50 DKR,  15 DM,  US$ 10, or
  742. the equivalent  in any  other currency. If you think I deserve it, this can
  743. be communicated in several ways:
  744.  
  745.  
  746. * By mail: Wrap the bills in some dark paper and write  me letter  and give
  747. me a  few comments,  tell me  a bit  about your Amiga and what you're doing
  748. with it.
  749. * By EuroCheque, addressed  to "Jesper  Juul". Remember  to write  the card
  750. number at the back of the cheque.
  751. * In most countries, you can pay at the post office via my Giro account:
  752. Girobank Denmark, 1-205-3207.
  753. * But no national cheques, not even Bank-signed ones.
  754.  
  755. If you don't feel like sending money, you can mail me something else:
  756.  
  757. *  Records,  tapes  and  CDs!  (Keywords:  Pixies, Stravinsky, Jethro Tull,
  758. Living Colour.)
  759. * Good books! (Keywords: Paul Auster, Jonathan Culler, Douglas Adams, Jorge
  760. Luis Borges.)
  761. * Or some (preferably good) software you've written.
  762. * Or  if you  make something like t-shirts or posters or videos or demos or
  763. anything from the program, I'd like a copy.
  764. * Or whatever you think.
  765.  
  766. * No  matter  what  you  do,  be  sure  to  mail  me  some  comments and/or
  767. suggestions!
  768.  
  769.  
  770. Anyway, this is my address:
  771.  
  772.  
  773.                   Jesper Juul
  774.                   Guldsmedgade 34, 1.
  775.                   DK-8000 Aarhus C.
  776.                   Denmark
  777.  
  778. E-mail:           norjj@stud.hum.aau.dk
  779.  
  780.  
  781. V1.5                  - Lyapunovia Users' Guide -                   Page 13
  782.  
  783.  
  784.                                   Notes:
  785.                                   ======
  786.  
  787. The future
  788. ----------
  789. There are (still) a lot of things I might want to add to this program.
  790.  
  791. -Speed.
  792. -Movie mode, letting you save animation-files.
  793. -A color dithering mode.
  794. -Extended rendering choices.
  795. -More mathematical formulas to choose from.
  796. -Whatever you can think of....... AREXX interface and SCSI support?
  797.  
  798.  
  799. An  animation  mode  is  the  next  project,  after  that I'll probably try
  800. looking at some other formulas.
  801.  
  802.  
  803.  
  804.                               Lighter notes:
  805.                               ==============
  806.  
  807.      "It's too bad they don't do this covernote thing anymore,  'cause it's
  808.      not a bad thing to say something, even if it doesn't amount to much."
  809.           -Ian Anderson
  810.  
  811.  
  812. The hard road to excess
  813. -----------------------
  814. Lyapunovia  was  written  in  100%  pure  assembler. It was written late at
  815. night, early in  the  morning,  while  cooking  Spaghetti  Bolognese, while
  816. brushing my  teeth, while  I was supposed to be doing something else, while
  817. half asleep, while everybody  else was  watching TV,  while I  had too many
  818. drinks the  night before, while I didn't really want to, while under almost
  819. divine inspiration, while reading, while making  phonecalls, while watching
  820. the tiny  little bit  of blue  sky I can see from my room if I push my head
  821. flat against the window and look directly up,  while singing  loudly, while
  822. thinking  'bout  the  night  before,  while  drying  my  hair, while eating
  823. breakfast, while snapping my fingers, and while I was in small gaps between
  824. everything  else  that  my  life  contains.  And  now  it's here. Makes you
  825. wonder....
  826.  
  827.  
  828. Slogans
  829. -------
  830.  
  831. The official slogan of this manual is, as you know, this:
  832.  
  833.      "Why do I have to keep reading these technical manuals?"
  834.           -Roger Waters.
  835.  
  836.  
  837. The official slogan of this program was suggested by Iivo Vehvilainen:
  838.  
  839.      "Way off in some indistinguishable distance  was a  stunning peak that
  840.      overarched  the  sky,  climbed  and  climbed and spread out in flowing
  841.      aigrettes, agglomerates and archimandrites."
  842.           -Douglas Adams: Mostly Harmless.
  843.  
  844.  
  845.  
  846. V1.5                  - Lyapunovia Users' Guide -                   Page 14
  847.  
  848.  
  849. The official slogan of my entire life is this:
  850.  
  851.      "Though they may have won all the battles, we had all the good songs."
  852.           -Tom Lehrer.
  853.  
  854.  
  855. The slogans, by the way, are self-contained and have no slogans.
  856.  
  857.  
  858. Laws
  859. ----
  860.  
  861. The official law governing  the production  of this  program is Hofstadters
  862. law:
  863.  
  864.      "Things always take longer time to finish than you expect, even if you
  865.      take Hofstadters law into account."
  866.           -Douglas R. Hofstadter.
  867.  
  868.  
  869. Copyrights
  870. ----------
  871.  
  872. Lyapunovia is © 1992-93 Jesper Juul.
  873.  
  874. ReqTools is © Nico Francois.
  875.  
  876. The rest of the copyrights belong to whoever owns them.
  877.  
  878.  
  879. Thanks go to:
  880. -------------
  881.  
  882. Nico Francois for ReqTools.
  883. Jan van den Baard for GadgetEd.
  884. Stefan Borberg for LhA.
  885. Olaf "Olsen" Barthel for Term.
  886. Fred Fish for his library.
  887.  
  888. Mads Christiansen, Mads Rydahl  and  Jens  Christian  Hansen  for different
  889. things.
  890. (The  former  Mads  especially  for  showing  me  the  article  that got me
  891. started, the latter Mads for designing disklabels.)
  892.  
  893. Kaare Heinsen, Phill Coxon, Jesper Skov, and Jes Sørensen for beta-testing.
  894. (Special thanks to Jesper for "answering questions".)
  895.  
  896. Lotte, Kim, Annette,  Anne,  Henrik,  Lilo,  Line,  Marianne,  Hanne, Lars,
  897. Rasmus, and Trine for endurance.
  898.  
  899. And finally, the great mathematical minds behind it all:
  900. A. K. Dewdney, Mario Markus, Benno Hess, and Aleksandr M. Lyapunov.
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911. V1.5                  - Lyapunovia Users' Guide -                   Page 15
  912.  
  913.  
  914.                                  Footnotes
  915.                                  =========
  916.  
  917.  
  918. NOTE 1:
  919.  
  920. On Amigas without Fastmem, selecting 16 colors in hires mode (256 colors, a
  921. 1280 pixel  screen on  AGA machines)  will significantly  slow down program
  922. execution.  But  also  notice  that  this  is only true when the Lyapunovia
  923. screen is  being  displayed.  Therefore,  bring  Workbench  to  front while
  924. Lyapunovia is  calculating; the  screen will  automatically be re-displayed
  925. when the picture has finished.
  926.  
  927.  
  928. NOTE 2:
  929.  
  930. When  saving  an  IFF   file,  Lyapunovia   will  include   the  coordinate
  931. parameters,  thus  enabling  you  to  load  the picture some other time and
  932. continue zooming.  However:  If  you  process  the  picture  (in  a drawing
  933. program, for example), that information will be lost, so keep a copy of the
  934. orignal file. (For the technically interested: The information  is saved as
  935. a TEXT chunk, which is probably the best solution.) 
  936.  
  937.  
  938. NOTE 3:
  939.  
  940. The  "iteration"  parameter  is  a  source of frequent misunderstanding for
  941. experienced Mandelbrot users.  Lyapunovia  is  very  different  in  that an
  942. increased number  of iterations has nothing to do with increased precision;
  943. rather a low iteration count leads to smooth  curvy pictures,  a high count
  944. leads to ragged and chaotic pictures. Precision is constant.
  945.  
  946.  
  947. NOTE 4:
  948.  
  949. You should  of course  use the program version that suits your system best.
  950. The 68020+ version will be faster than the normal version,  the FPU version
  951. will  _generally_  be  faster  than  the  68020+  version. However: On some
  952. systems, single precision calculations will  actually  be  faster  with the
  953. 68020+  than   with  the  FPU  version.  And  also:  Single  precision  FPU
  954. calculations are a bit less precise.
  955. The  program  attemps  to  automatically  adjust  the  level  of  precision
  956. according to the zoom depth. With FPUs, the program may not be that good at
  957. guessing the needed precision.  With an  FPU, my  best advice  is to select
  958. "double precsion" at all times.
  959.